.. _CScreenStart Class: ========================== CScreenStart Class ========================== .. toctree:: :maxdepth: 1 * :ref:`Overview` * :ref:`Quick Reference` * :ref:`Constructors` * :ref:`Methods` ---- .. _CScreenStart_Overview: Overview --------------- .. note:: The **CScreenStart** class handles the main title screen dialogs and buttons, including game options, game campaign, singleplayer, multiplayer, credits, etc The structure used for this class is :ref:`CScreenStart` ---- .. _CScreenStart_QuickRef: Quick Reference --------------- +-------------------------------------------------------------------------------------------------------------------------------------+ | **Quick Ref** | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:CScreenStart**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | virtual int **CScreenStart\:\:CheckMouseMove**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:ClearSaveGameName**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:DismissChooseCampaignPopup**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | virtual void **CScreenStart\:\:EngineActivated**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | virtual void **CScreenStart\:\:EngineDeactivated**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | virtual void **CScreenStart\:\:EngineDestroyed**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | virtual void **CScreenStart\:\:EngineInitialized**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | int **CScreenStart\:\:GetCampaign**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`CString` **CScreenStart\:\:GetContinueSaveGameName**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | virtual int **CScreenStart\:\:GetEngineState**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | virtual short **CScreenStart\:\:GetNumVirtualKeys**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | virtual :ref:`CKeyInfo`\* **CScreenStart\:\:GetVirtualKeys**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | virtual int\* **CScreenStart\:\:GetVirtualKeysFlags**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | int **CScreenStart\:\:HasGameToContinue**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnCampaignButtonClick**\(char\* campaign, bool playIntro) | +-------------------------------------------------------------------------------------------------------------------------------------+ | bool **CScreenStart\:\:OnContinueGame**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnCreatePartyButtonClick**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnDLCImageClick**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnImportCharacterButtonClick**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | virtual void **CScreenStart\:\:OnKeyDown**\(int nKeysFlags) | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnLoadGameButtonClick**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnMultiPlayerButtonClick**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnNewGameButtonClick**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnOptionsButtonClick**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnPreGenerateButtonClick**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnPregenSelectButtonClick**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnQuitButtonClick**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnSoAButtonClick**\(bool playIntro) | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnTBPButtonClick**\(bool playIntro) | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnToBButtonClick**\(bool playIntro) | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:OnTutorialButtonClick**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | void **CScreenStart\:\:ReadyEndCredits**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | virtual void **CScreenStart\:\:TimerAsynchronousUpdate**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ | virtual void **CScreenStart\:\:TimerSynchronousUpdate**\() | +-------------------------------------------------------------------------------------------------------------------------------------+ ---- .. _CScreenStart_Constructors: Constructors --------------- +---------------------------------------------------------------+------------------------------------------------------+ | **Name** | **Description** | +---------------------------------------------------------------+------------------------------------------------------+ | :ref:`CScreenStart\:\:CScreenStart` | Constructs a ``CScreenStart`` object | +---------------------------------------------------------------+------------------------------------------------------+ .. _CScreenStartCScreenStart: CScreenStart\:\:CScreenStart ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Constructs a ``CScreenStart`` object :: void CScreenStart::CScreenStart(); **Remarks** Constructs a ``CScreenStart`` object ---- .. _CScreenStart_Methods: Methods --------------- +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | **Name** | **Description** | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:CheckMouseMove` | Determines if mouse has moved | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:ClearSaveGameName` | Clear save game filename | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:DismissChooseCampaignPopup` | Closes choose campaign dialog | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:EngineActivated` | | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:EngineDeactivated` | | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:EngineDestroyed` | | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:EngineInitialized` | | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:GetCampaign` | Get the campaign | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:GetContinueSaveGameName` | Returns a string containing the save game filename | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:GetEngineState` | Returns the engine state | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:GetNumVirtualKeys` | | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:GetVirtualKeys` | | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:GetVirtualKeysFlags` | | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:HasGameToContinue` | Determines if there is an existing game already saved, ready to be continued | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnCampaignButtonClick` | Event action for when campaign button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnContinueGame` | Event action for when continue game button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnCreatePartyButtonClick` | Event action for when create party button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnDLCImageClick` | Event action for when a dlc button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnImportCharacterButtonClick` | Event action for when import character button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnKeyDown` | Key event for a key being pressed | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnLoadGameButtonClick` | Event action for when load game button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnMultiPlayerButtonClick` | Event action for when multiplayer button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnNewGameButtonClick` | Event action for when new game button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnOptionsButtonClick` | Event action for when options button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnPreGenerateButtonClick` | Event action for when pre-generate button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnPregenSelectButtonClick` | Event action for when a selection button in the pre-generate is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnQuitButtonClick` | Event action for when quit button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnSoAButtonClick` | Event action for when Shadows of Amn button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnTBPButtonClick` | Event action for when The Black Pits button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnToBButtonClick` | Event action for when Throne of Bhaal button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:OnTutorialButtonClick` | Event action for when tutorial button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:ReadyEndCredits` | Event action for when credits button is clicked | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:TimerAsynchronousUpdate` | Update timer asynchronously | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`CScreenStart\:\:TimerSynchronousUpdate` | Update timer synchronously | +-----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ ---- .. _CScreenStartCheckMouseMove: CScreenStart\:\:CheckMouseMove ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Determines if mouse has moved :: virtual int CScreenStart::CheckMouseMove(); **Return Value** Returns ``int`` **Remarks** ---- .. _CScreenStartClearSaveGameName: CScreenStart\:\:ClearSaveGameName ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Clear save game filename :: void CScreenStart::ClearSaveGameName(); **Remarks** ---- .. _CScreenStartDismissChooseCampaignPopup: CScreenStart\:\:DismissChooseCampaignPopup ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Closes choose campaign dialog :: void CScreenStart::DismissChooseCampaignPopup(); **Remarks** ---- .. _CScreenStartEngineActivated: CScreenStart\:\:EngineActivated ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ :: virtual void CScreenStart::EngineActivated(); **Remarks** ---- .. _CScreenStartEngineDeactivated: CScreenStart\:\:EngineDeactivated ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ :: virtual void CScreenStart::EngineDeactivated(); **Remarks** ---- .. _CScreenStartEngineDestroyed: CScreenStart\:\:EngineDestroyed ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ :: virtual void CScreenStart::EngineDestroyed(); **Remarks** ---- .. _CScreenStartEngineInitialized: CScreenStart\:\:EngineInitialized ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ :: virtual void CScreenStart::EngineInitialized(); **Remarks** ---- .. _CScreenStartGetCampaign: CScreenStart\:\:GetCampaign ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Get the campaign :: int CScreenStart::GetCampaign(); **Return Value** Returns an ``int`` value representing campaign id **Remarks** ---- .. _CScreenStartGetContinueSaveGameName: CScreenStart\:\:GetContinueSaveGameName ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Returns a string containing the save game filename :: CString CScreenStart::GetContinueSaveGameName(); **Return Value** Returns a :ref:`CString` containing the save game **Remarks** See also :ref:`CScreenStart\:\:HasGameToContinue` ---- .. _CScreenStartGetEngineState: CScreenStart\:\:GetEngineState ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Returns the engine state :: virtual int CScreenStart::GetEngineState(); **Return Value** Returns an ``int`` value representing the engine state **Remarks** ---- .. _CScreenStartGetNumVirtualKeys: CScreenStart\:\:GetNumVirtualKeys ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ :: virtual short CScreenStart::GetNumVirtualKeys(); **Return Value** Returns a ``short`` value **Remarks** ---- .. _CScreenStartGetVirtualKeys: CScreenStart\:\:GetVirtualKeys ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ :: virtual CKeyInfo* CScreenStart::GetVirtualKeys(); **Return Value** Returns :ref:`CKeyInfo`\* **Remarks** ---- .. _CScreenStartGetVirtualKeysFlags: CScreenStart\:\:GetVirtualKeysFlags ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ :: virtual int* CScreenStart::GetVirtualKeysFlags(); **Return Value** Returns ``int``\* **Remarks** ---- .. _CScreenStartHasGameToContinue: CScreenStart\:\:HasGameToContinue ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Determines if there is an existing game already saved, ready to be continued :: int CScreenStart::HasGameToContinue() ; **Return Value** Returns an ``int`` representing true ``1`` or false ``0`` **Remarks** See also :ref:`CScreenStart\:\:GetContinueSaveGameName` ---- .. _CScreenStartOnCampaignButtonClick: CScreenStart\:\:OnCampaignButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when campaign button is clicked :: void CScreenStart::OnCampaignButtonClick( char* campaign, bool playIntro); **Parameters** * ``char``\* campaign - *CAMPAIGN.2DA column label* * ``bool`` playIntro - *play intro movie or not* **Remarks** Optionally plays intro movie if *playIntro* parameter is ``true``. Loads 2da file under the CAMPAIGN.2DA *campaign* column label. Writes to Baldur.lua the active campaign id, the ``Active Campaign`` key value under the ``Program Options`` section. :ref:`CScreenStart\:\:OnCampaignButtonClick` is called from :ref:`CScreenStart\:\:TimerAsynchronousUpdate` and tolua_BaldurLUA_CScreenStart_OnCampaignButtonClick00 ---- .. _CScreenStartOnContinueGame: CScreenStart\:\:OnContinueGame ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when continue game button is clicked :: bool CScreenStart::OnContinueGame(); **Return Value** Returns ``bool`` - true ``1`` or false ``0`` **Remarks** ---- .. _CScreenStartOnCreatePartyButtonClick: CScreenStart\:\:OnCreatePartyButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when create party button is clicked :: void CScreenStart::OnCreatePartyButtonClick(); **Remarks** ---- .. _CScreenStartOnDLCImageClick: CScreenStart\:\:OnDLCImageClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when a dlc button is clicked :: void CScreenStart::OnDLCImageClick(); **Remarks** ---- .. _CScreenStartOnImportCharacterButtonClick: CScreenStart\:\:OnImportCharacterButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when import character button is clicked :: void CScreenStart::OnImportCharacterButtonClick(); **Remarks** ---- .. _CScreenStartOnKeyDown: CScreenStart\:\:OnKeyDown ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Key event for a key being pressed :: virtual void CScreenStart::OnKeyDown(int nKeysFlags); **Parameters** * ``int`` nKeysFlags - * * **Remarks** ---- .. _CScreenStartOnLoadGameButtonClick: CScreenStart\:\:OnLoadGameButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when load game button is clicked :: void CScreenStart::OnLoadGameButtonClick(); **Remarks** ---- .. _CScreenStartOnMultiPlayerButtonClick: CScreenStart\:\:OnMultiPlayerButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when multiplayer button is clicked :: void CScreenStart::OnMultiPlayerButtonClick(); **Remarks** ---- .. _CScreenStartOnNewGameButtonClick: CScreenStart\:\:OnNewGameButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when new game button is clicked :: void CScreenStart::OnNewGameButtonClick(); **Remarks** ---- .. _CScreenStartOnOptionsButtonClick: CScreenStart\:\:OnOptionsButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when options button is clicked :: void CScreenStart::OnOptionsButtonClick(); **Remarks** ---- .. _CScreenStartOnPreGenerateButtonClick: CScreenStart\:\:OnPreGenerateButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when pre-generate button is clicked :: void CScreenStart::OnPreGenerateButtonClick(); **Remarks** Allows player to select pre-generated characters from a list in a dialog to play in the game ---- .. _CScreenStartOnPregenSelectButtonClick: CScreenStart\:\:OnPregenSelectButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when a selection button in the pre-generate is clicked :: void CScreenStart::OnPregenSelectButtonClick(); **Remarks** ---- .. _CScreenStartOnQuitButtonClick: CScreenStart\:\:OnQuitButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when quit button is clicked :: void CScreenStart::OnQuitButtonClick(); **Remarks** ---- .. _CScreenStartOnSoAButtonClick: CScreenStart\:\:OnSoAButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when Shadows of Amn button is clicked :: void CScreenStart::OnSoAButtonClick(bool playIntro); **Parameters** * ``bool`` playIntro - *play intro movie or not* **Remarks** Optionally plays intro movie if *playIntro* parameter is ``true``. Plays ``INTRO15F.WBM`` or ``INTRO.WBM`` movie. Sets start area based on contents of ``STARTARE.2DA`` - using the ``START_AREA`` value which is currently set to ``AR0602`` for **Shadows of Amn**. Loads 2da file under the ``CAMPAIGN.2DA`` ``IWDPARTY`` column. Writes to Baldur.lua the active campaign id, the ``Active Campaign`` key value under the ``Program Options`` section. :ref:`CScreenStart\:\:OnSoAButtonClick` is called from :ref:`CScreenStart\:\:TimerAsynchronousUpdate` and tolua_BaldurLUA_CScreenStart_OnSoAButtonClick00 ---- .. _CScreenStartOnTBPButtonClick: CScreenStart\:\:OnTBPButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when The Black Pits button is clicked :: void CScreenStart::OnTBPButtonClick(bool playIntro); **Parameters** * ``bool`` playIntro - *play intro movie or not* **Remarks** Optionally plays intro movie if *playIntro* parameter is ``true``. Plays ``BLACKPIT.WBM`` movie. Sets start area based on contents of ``STARTBP.2DA`` - using the START_AREA value which is currently set to ``OH8000`` for **The Black Pits**. Loads 2da file under the ``CAMPAIGN.2DA`` ``TBPPARTY`` column. Writes to Baldur.lua the active campaign id, the ``Active Campaign`` key value under the ``Program Options`` section. :ref:`CScreenStart\:\:OnTBPButtonClick` is called from :ref:`CScreenStart\:\:TimerAsynchronousUpdate` and tolua_BaldurLUA_CScreenStart_OnTBPButtonClick00 ---- .. _CScreenStartOnToBButtonClick: CScreenStart\:\:OnToBButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when Throne of Bhaal button is clicked :: void CScreenStart::OnToBButtonClick(bool playIntro); **Parameters** * ``bool`` playIntro - *play intro movie or not* **Remarks** Optionally plays intro movie if *playIntro* parameter is ``true``. Plays ``INTRO.WBM`` movie (references ``HOWSEER`` as an alternative movie?). Sets start area based on contents of ``STARTARE.2DA`` - using the ``START_AREA_MP`` value which is currently set to ``AR4000`` for **Throne of Bhaal**. Loads 2da file under the ``CAMPAIGN.2DA`` ``HOWPARTY`` column. Writes to Baldur.lua the active campaign id, the ``Active Campaign`` key value under the ``Program Options`` section. :ref:`CScreenStart\:\:OnToBButtonClick` is called from tolua_BaldurLUA_CScreenStart_OnToBButtonClick00 ---- .. _CScreenStartOnTutorialButtonClick: CScreenStart\:\:OnTutorialButtonClick ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when tutorial button is clicked :: void CScreenStart::OnTutorialButtonClick(); **Remarks** Sets start area based on contents of ``STARTARE.2DA`` - using the ``START_AREA_TUTORIAL`` value which is currently set to ``AR0015`` for **Tutorial** Calls :ref:`CScreenStart\:\:OnNewGameButtonClick` to start a new game begining with the tutorial. :ref:`CScreenStart\:\:OnTutorialButtonClick` is called from tolua_BaldurLUA_CScreenStart_OnTutorialButtonClick00 ---- .. _CScreenStartReadyEndCredits: CScreenStart\:\:ReadyEndCredits ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Event action for when credits button is clicked :: void CScreenStart::ReadyEndCredits(); **Remarks** ---- .. _CScreenStartTimerAsynchronousUpdate: CScreenStart\:\:TimerAsynchronousUpdate ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Update timer asynchronously :: virtual void CScreenStart::TimerAsynchronousUpdate(); **Remarks** Processes a number of possible options: end credits to play based on ``2DECRED.2DA``, show splash screen, game options dialog, campaign button, SoA button, ToB button, TBP button etc. Calls the following functions: :ref:`CScreenStart\:\:OnSoAButtonClick`, :ref:`CScreenStart\:\:OnTBPButtonClick` and :ref:`CScreenStart\:\:OnCampaignButtonClick` ---- .. _CScreenStartTimerSynchronousUpdate: CScreenStart\:\:TimerSynchronousUpdate ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Update timer synchronously :: virtual void CScreenStart::TimerSynchronousUpdate(); **Remarks**